home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Tampa Bay Amiga Group / TBAG - Tampa Bay Amiga Group's Disk of the Month #77 (1993)(Merlin's Software - Amiganuts United)(PD).zip / TBAG - Tampa Bay Amiga Group's Disk of the Month #77 (1993)(Merlin's Software - Amiganuts United)(PD).adf / Docs / ARestaure.docs next >
Text File  |  1993-01-03  |  6KB  |  193 lines
  1.  
  2.      //                 ARestaure v1.00 - Documentation            //
  3.    \X/                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~          \X/
  4.  
  5.     
  6.     ARestaure  is  placed  in  Public  Domain, it  can  be  freely
  7. distributed, you can spread  it in the way you want,  but  the program
  8. MUST be  distributed  WITH its  documentation  in  all languages  (for
  9. instance  French,  German and English) without ANY  modification.
  10.  
  11.     ARestaure  is ©1992 by Jehan-Yves PROUX, the commercial use is
  12. STRICLY FORBIDDEN without author written agreement.
  13.  
  14.     I  made  a lot of  tests,  but I  declines  any responsability
  15. about the use of ARestaure. YOU ARE USING THIS TOOLS AT YOUR OWN RISK.
  16. The author  is not  responsible  of any  damage, as result of  the use
  17. of his program.
  18.  
  19.  
  20.  
  21. Contents.
  22. ~~~~~~~~~
  23.  
  24.     1. Introduction.
  25.     2. How does it works?
  26.     3. Usage
  27.     4. Languages supported
  28.     5. Thanks
  29.     6. Conclusion
  30.  
  31.  
  32.  
  33. 1. Introduction.
  34. ~~~~~~~~~~~~~~~~
  35.  
  36.     Have  you  ever  delete  accidentally a file  or see  after  a
  37. "delete #?" that you were not in the rigth directory ?
  38.  
  39.     Yes? I  too... It's why I have written this utility ARestaure,
  40. which as it name says (with french spelling), permits  you to  restore
  41. files that you have destroyed...
  42.  
  43.  
  44. 2. How does it works?
  45. ~~~~~~~~~~~~~~~~~~~~~
  46.  
  47.     When you delete a file two main actions occurs on your current
  48. volume:
  49.         - your file is disconnected from the directory tree of
  50.             your volume.
  51.  
  52.         - sectors that  your file  owned, are declared free in
  53.             the  BitMap  block(s)  of your  volume.  These
  54.             sectors are never zeroed during this operation
  55.             : the datas are still on your disk.
  56.  
  57.     ARestaure  will  scan your volume, searching for deleted files
  58. and permit you to undelete them.
  59.  
  60.  
  61. 3. Usage.
  62. ~~~~~~~~
  63.  
  64.     To start ARestaure, click on its icon on the Workbench or type
  65. "ARestaure" under the Shell.
  66.  
  67.     ARestaure will start to search in your system all the  volumes
  68. that it can manage,  and it will  show you only these  ones  : Also if
  69. you have  a Mac, Unix, Atari, C=64, Sinclair QL,  Apple-II, or why not
  70. an MS-DOS partition, you won't see it on your screen.
  71.     In fact, ARestaure know only how to manage Amiga partitions or
  72. volumes: OFS (the Old Filing System) and FFS (the Fast Filing System),
  73. that  it  means about  98%  of  disks  connected with  our  well-known
  74. machine.
  75.  
  76.     You  will notice  that ARestaure cannot restore a file deleted
  77. on RAM:, this volume  is purely memory, and space used by your file is
  78. freed when your file  is deleted, it's why RAM: is not  shown on  your
  79. screen. But ARestaure can restore files lost in RAD:.
  80.  
  81.     You have on your screen the following buttons:
  82.  
  83.     DF0: .. DF3:    one button per drive connected (empty or not)
  84.     DH0: .. DHx:
  85.     ..    ..
  86.     ..    ..
  87.     ..    ..
  88.     ..    ..    and as many buttons as you have drivers
  89.  
  90.     Français
  91.     Deutsch        to change the current language
  92.     English
  93.  
  94.     SaveCfg        to save the chosen language
  95.  
  96.     Quit        to quit ARestaure.
  97.  
  98.  
  99.     If you  select  a  drive,  the  program will begin the  search
  100. immediatly on this drive. A flashing LED on the drive button indicates
  101. that the program continue to search.
  102.     NOTA:    You  can  stop the  scan by  pressing the  left  mouse
  103. button (called SELECT in Amiga docs).
  104.  
  105.     If ARestaure cannot find any  files, it  will signal it to you
  106. in the message box; if it can, it will open a file requester where you
  107. can select the files  you  want to  restaure,  then  type  <Cancel> or
  108. <ARestaure>.  After that you  will  be back  in  the starting  menu to
  109. select another drive or to quit.
  110.  
  111.     Where to find  your  files? It  is  impossible to restore your
  112. files in the places  they  were  before the  deletion  because  it  is
  113. impossible to find where  they  were linked  in  the directory tree of
  114. your volume. Also I had decided to restore them in  T:,  the temporary
  115. directory of the  Amiga.   Usually, T: is assigned to RAM:  (see  your
  116. Startup-Sequence). After the  restoration, you only  have  to move the
  117. restored files from T: to where you want.
  118.     NOTA:    You should have to enough room in T: for the files you
  119. want to restore.
  120.  
  121.  
  122. 4. Languages Supported.
  123. ~~~~~~~~~~~~~~~~~~~~~~~
  124.  
  125.     ARestaure is  now  almost  ready for the  Amiga Workbench 2.1,
  126. which will support up to  8 languages (according to C=Amiga austria in
  127. Amiga Magazin [german magazine] on 9/92): ARestaure supports the three
  128. languages  I  understand:  French  (my  native  langage),  german  and
  129. english.
  130.  
  131.  
  132.     You  can select the language you want on the main screen. But,
  133. it's impossible to change the current language, when you have the file
  134. requester opened  :  I  didn't  want to manage this, I suppose in fact
  135. that  a normal user  needn't  to change  the current language  all the
  136. time.
  137.  
  138.     I  think that  in the Amiga Workbench  2.1,  there will  be  a
  139. variable like  $LANG,  on Unix  machines,  which  indicates  the  user
  140. language. But with no more information from C=Amiga, I offer you these
  141. three language buttons.
  142.  
  143.     To  finish with languages, if you  want to  get  a translation
  144. for  the docs  of your software  (that  YOU  have  created  for Public
  145. Domain only), from german or english to french, please write to me.
  146.  
  147.     P.S:    I'm searching  for someone who can correct  my  german
  148. docs, which certainly contains some mistakes.
  149.     
  150.  
  151. 5. Thanks
  152. ~~~~~~~~~
  153.  
  154.     I want to thanks here the following persons and firms:
  155.  
  156.     - Muriel PROUX,  my wife for her patience and help in building
  157.         my user interface.
  158.  
  159.     - Denis GOUNELLE, for his ideas and tests of béta-versions, he
  160.         makes on his machine.
  161.  
  162.     - Henric GOMES, who made me discover the wonderfull Amiga.
  163.  
  164.     - Commodore-Amiga for the machine... What a pity that C= sells
  165.         MS-DOS machines too...
  166.  
  167.     - Free Software Fundation for the best editor I    know:
  168.         GNUEmacs, I used  GNUEmacs on Unix machine  and on the
  169.         Amiga.
  170.  
  171.  
  172.     - David GAY  (Switzerland)  for  his GNUEmacs'  Amiga  port, a
  173.         very good job, David ! Continue to work for the Amiga.
  174.  
  175.  
  176. 6. Conclusion
  177. ~~~~~~~~~~~~~
  178.  
  179.     I'm waiting for your suggestions  and beta-tests (there may be
  180. some  problems, which  escaped from  source inspection !) and donation
  181. (in ready cash preferably), if I save you long hours of work.
  182.     You can write  me in french, in german or in english [in order
  183. of  my  preferences,  the  French  language  is  my   motherlanguage].
  184. My address is the following:
  185.  
  186.         Jehan-Yves PROUX
  187.         46bis, Bd Robespierre
  188.         F-78300 Poissy
  189.         FRANCE - EUROPE
  190.  
  191.  
  192.     C U soon !!
  193.